home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / utility / xset402.zip / INTRO < prev    next >
Text File  |  1994-03-29  |  15KB  |  480 lines
  1. Subj: XSET402.ZIP
  2.  
  3.  
  4.  Thanks for your interest to XSET.
  5.  Due to a lot of requests  from  registers  users,  I  decided  to  add
  6.  several more features to XSET. Here is the shareware  version  of  the
  7.  program; uudecode it, unzip it and try it!
  8.  
  9.  I guaranty it virus free (it is compiled on a stand-alone computer and
  10.  a scanning is performed each week).
  11.  
  12.  Distribute it to as many people as you want and upload it to  as  many
  13.  BBS or servers as you can.
  14.  
  15.  
  16.                         Shareware concept  
  17.                         =================
  18.  
  19.  
  20.     This package is Shareware.
  21.  
  22.     That means that you may try it for evaluation and, if you like  it,
  23.     you should consider to pay  the  registration  fee  (see  the  file
  24.     'REGISTER.HOW'). You will then become a registred user and so  have
  25.     access to free support and free correction of aknowledged bugs.
  26.  
  27.     Shareware also mean that you may distribute this package everywhere
  28.     and to everybody you want, providing that you always distribute the
  29.     complete package. If you have access to any BBS, FTP server, E-mail
  30.     server or any other kind of software  distribution,  feel  free  to
  31.     share it with other people; this may be useful  for  them  and  the
  32.     more people will use (and register) a shareware program,  the  more
  33.     stable it will be and the more functionalities could be added.
  34.  
  35.  
  36.     Warning:  If you paid to get this  package  (e.g.  it  was  onto  a
  37.     -------   floppy with other programs,  you  downloaded  it  from  a
  38.               BBS), you only paid for the physical support (the floppy,
  39.               the transmission fee,...);  this  does  not  replace  the
  40.               registration fee.
  41.  
  42.  
  43.     Note to software distributors:
  44.     -----------------------------
  45.  
  46.          Nobody is allowed to make any benefit by distributing the XSET
  47.          package. Only regular distribution fee are allowed  (price  of
  48.          the floppy, of the network connection,...).
  49.  
  50.  
  51.  
  52.  
  53.                                               Marc Stern
  54.  
  55. -----------------------------------------------------------------------
  56.  
  57. File name:    XSET402.ZIP
  58. Description:  Put ANYTHING in environment variable - GREAT
  59.  
  60. Author:       Stern Marc (uploaded by the author)
  61.  
  62. E-mail:       stern@mble.philips.be           (internet)
  63.               >INTERNET:stern@mble.philips.be (compuserve)
  64.  
  65. Address:      Av. de la basilique 376 b19 - 1080 Bruxelles - Belgium  
  66. Tel:          +32-2 525.63.32 ( 9h - 16h Medium European Time )
  67.               +32-2 427.98.52 ( after 18h )
  68.  
  69. Hardware requirements:   any compatible PC (XT, AT 286, 386, 486,...)
  70. Software requirements:   compatible with MS-DOS, PC-DOS, DR-DOS, 4DOS,
  71.                                          NDOS, Windows, OS/2, ...
  72. Memory   requirements:   less than 100 Kb to run
  73.  
  74. Shareware (cheap)
  75. Full-functionalities version
  76. Self-documenting and external documentation included
  77. Source not included
  78.  
  79. -----------------------------------------------------------------------
  80.                              History of XSET
  81.                              ===============
  82.  
  83. Version 4.02
  84. ============
  85.                      
  86.   Changes:
  87.   -------
  88.    - DIFFDATE   also allows 4 digits years (94, 1994, ...)
  89.  
  90.  
  91.   New functionalities:
  92.   -------------------
  93.  
  94.     - XSET handles the special case of  the  variable  'windir'  created  in
  95.       Windows DOS boxes that you normally cannot use.
  96.       
  97.     
  98.   Bug corrections:
  99.   ---------------
  100.  
  101.    - ERRORLEVEL return was wrong for MS-DOS 6.0
  102.    - some problems dedicated to demo version in some very particular
  103.      configurations 
  104.  
  105.  
  106.  
  107. Version 4.00
  108. ============
  109.                      
  110.   Changes:
  111.   -------
  112.    - ERRORLEVEL is PC-DOS 6.1 and MS-DOS 6.2 compatible
  113.  
  114.    -  /TIMEOUT  n 
  115.       Line input: If n < 0, time-out will be active during the  whole  input
  116.                   process; if you wait more than abs(n) seconds between  two
  117.                   keys, the program will return the string typed so far.
  118.       KEY input: the program will return after  the  specified  time  if  no
  119.                  valid key was hit.
  120.                  ^^^^^
  121.                      
  122.   New functionalities:
  123.   -------------------
  124.  
  125.     - /SEPARATOR string       
  126.       This uses the characters from 'string' as word separator.
  127.       This option is intended to be used with /WORD and /COUNT.
  128.  
  129.     - RANDOM n1 n2
  130.       This generates a random integer number between n1 and n2.
  131.  
  132.  
  133.  
  134. Version 3.50
  135. ============
  136.                      
  137.   New functionalities:
  138.   -------------------
  139.  
  140.   This version now fully supports full edition of input lines.
  141.   
  142.     Valid keys:   Home         Begin of line
  143.                   End          End of line
  144.                   Left/Right   One character left/right
  145.                   Insert       Toggle isert on/off
  146.                   Delete       Delete current  character
  147.                   BackSpace    Delete previous character
  148.                   Ctrl-home    Erase to begin-of-line
  149.                   Ctrl-end     Erase to end-of-line
  150.                   Escape       Erase whole input
  151.                   Enter        Accept input
  152.   
  153.   
  154.   /DEFAULT       set current value as default for the input prompt
  155.   
  156.   /TIMEOUT n     breaks the input if no key was hit after n seconds
  157.   
  158.   /COLOR  <color>       change prompt color
  159.          valid colors = BLACK BLUE GREEN CYAN RED MAGENTA BROWN DARKGRAY
  160.                         LIGHTGRAY LIGHTBLUE LIGHTGREEN LIGHTCYAN LIGHTRED
  161.                         LIGHTMAGENTA YELLOW WHITE
  162.                         HIGHLIGHT REVERSE
  163.   
  164.   /BACKGROUND  <color>   will change prompt background color
  165.           valid colors = BLACK BLUE GREEN CYAN RED MAGENTA
  166.                          BROWN DARKGRAY LIGHTGRAY
  167.   
  168.   /BLINK                displays a blinking prompt
  169.   
  170.   /XPOS  x
  171.   Set cursor to column x (or current - abs(x) if x < 0) before displaying prompt.
  172.  
  173.   /YPOS  y
  174.   Set cursor to line y (or current - abs(y) if y < 0) before displaying prompt.
  175.  
  176.   /WINDOW  left top right bottom
  177.   Draw a window (using color specified with /BACKGROUND).  
  178.  
  179.   /BOX
  180.   Draw a window around the prompt .
  181.  
  182.   /BORDER
  183.   Add a border inside a window (specified with /WINDOW or /BOX).
  184.  
  185.   CPU     returns processor type (86, 186, 286, 386 or 486)
  186.   
  187.   VOLLABEL   returns the volume label of a disk
  188.   
  189.   DRIVETEST  tests if a disk drive is readable, writeable, invalid,
  190.              remote, removable, ram disk, subst, ...
  191.   
  192.   /LINE      accepts both positive and negative arguments:
  193.               1   will read first line 
  194.               2   will read second line 
  195.              -1   will read the last line,
  196.              -2   will read the line before, ...
  197.                 
  198.   XSET variable:   
  199.        Before scanning the command line, the XSET program  will  look  for
  200.        the 'XSET' variable into the current DOS environment. If it exists,
  201.        the XSET program will use the variable contents like  option  flags
  202.        you would have given onto the command line. After it will  use  the
  203.        option flags given onto the command line.
  204.              
  205.   XSET_MSG variable:
  206.        Assigned by the XSET program itself to specify special events.
  207.   
  208.   
  209.   Changes:
  210.   -------
  211.    - FTIME also returns seconds (hh:mm:ss)   
  212.    - ERRORLEVEL is MS-DOS 6.0 compatible
  213.    - /MATH accepts hexadecimal numbers followed by H
  214.    - /MATH accepts power expression ( x^y )
  215.    - KEY also returns non-printable characters as their decimal ASCII 
  216.          code preceeded by a '#'.
  217.    - /REGEXP accepts a new special character '?' matching 'zero or one time'.
  218.  
  219.  
  220.   Bug corrections:
  221.   ---------------
  222.  
  223.    - This version now fully supports non standard mode like 30 or 60 lines.
  224.    - bug fix in function FEXT when no extension in filename.
  225.    - XSET did not recognize empty strings on command-line ("").
  226.   
  227.  
  228.                   
  229.  
  230. Version 3.00
  231. ============
  232.  
  233.   Completely new interface to allow several operations in one shot.
  234.   
  235.   ex: XSET/LOWER /PROMPT "Enter a filename: " FPATH
  236.  
  237.   Type XSET /? to get the full description of all functionalities.
  238.  
  239.  
  240.  
  241. Version 2.60
  242. ============
  243.  
  244.         New commands added:
  245.  
  246. XSET /VIEW var   will show content of variable 'var'
  247.  
  248. This command is useful to use variables longer than 128 characters.
  249.  
  250. You can exit the help screen at any time by hitting Escape or Ctrl-C.
  251.  
  252.  
  253.  
  254. Version 2.50
  255. ============
  256.  
  257.         New commands added:
  258.  
  259. XSET /VIEW   display all environment variables
  260.  
  261.  
  262.  
  263. Version 2.40
  264. ============
  265.  
  266.         New commands added:
  267.  
  268. XSET /SIZE   display environment size and free size (in bytes).
  269.  
  270.         Bug correction:  bug fix in function DIFFDATE.
  271.  
  272.  
  273.  
  274. Version 2.30
  275. ============
  276.  
  277.         New commands added:
  278.  
  279. Commands    Arguments    Action and value assigned to <dosvar>
  280. --------    ---------    -------------------------------------
  281. DIFFDATE    date1 date2  number of days between date1 and date2 (date2 - date1)
  282.                          date format may be 'dd-mm-yy' or 'yymmdd'
  283.                          (may also be mixed)
  284.  
  285.         Bug correction:  WORD 1 sometimes returned wrong result.
  286.  
  287.  
  288.  
  289. Version 2.20
  290. ============
  291.  
  292.         New commands added:
  293.  
  294. Commands    Arguments    Action and value assigned to <dosvar>
  295. --------    ---------    -------------------------------------
  296. YYMMDD                   system date in 'yymmdd' format
  297. VARCOPY     variable     contents of DOS environment variable 'variable'
  298.  
  299. XSET /CLEAR   will clear delete all variables from environment\r\n\n"
  300.  
  301. XSET /LOAD    will load variables from standard input.
  302.               variables must have been saved with command 'SET'
  303.               ex:   save variables with 'SET > SAVEFILE.VAR'
  304.                   reload variables with 'XSET /LOAD < SAVEFILE.VAR'
  305.  
  306.  
  307.  
  308.         Enhancements:
  309.  
  310. Function 'PASSWD' accepts up to 127 characters
  311.  
  312. Function 'MATH'   accepts logical operators '= < > <= >='
  313.  
  314.  
  315.  
  316. Version 2.12
  317. ============
  318.  
  319.         Bug correction:  file functions returned TRUENAME.
  320.  
  321.  
  322.  
  323.  
  324. Version 2.11
  325. ============
  326.  
  327.         Bug correction: the BYTEFREE command was sometimes return -1.
  328.  
  329.  
  330.  
  331.  
  332. Version 2.10
  333. ============
  334.  
  335.         New commands added:
  336.  
  337. Commands    Arguments    Action and value assigned to <dosvar>
  338. --------    ---------    -------------------------------------
  339.  
  340. ERRORLEVEL  none         errorlevel code of last command
  341.  
  342. BYTEFREE    [drive]      number of bytes free on specified (or current) drive
  343.  
  344. DAYOFWEEK                day in the week ( 0 = sunday,... )
  345.  
  346. CHANGE      s1 s2 {s3}   change <s1> by <s2> in <s3>
  347.  
  348. SEARCH      str1 {str2}  portion of <str1> matching <str2>
  349.  
  350.  
  351. Version 2.03
  352. ============
  353.  
  354.         Bug correction: little problem appearing sometimes
  355.                         with KEY command.
  356.  
  357.         Bug correction: garbage display when no prompt specified
  358.                         with INPUT command.
  359.  
  360.         Bug correction: strange behaviour on certain machines
  361.                         when invoking for the first time the
  362.                         DENSITY command.
  363.  
  364. Version 2.02
  365. ============
  366.  
  367.         Bug correction: all INPUT commands where buggy 
  368.                         (due to a compilation problem).
  369.  
  370. Version 2.01
  371. ============
  372.  
  373.         Bug correction: the command TRUENAME always returned an empty
  374.                         string (due to a last minute change).
  375.  
  376. Version 2.0
  377. ===========
  378.  
  379.         New commands added:
  380.  
  381. Commands    Arguments    Action and value assigned to <dosvar>
  382. --------    ---------    -------------------------------------
  383.  
  384. MIN      ┌{str1...strn}    minimum or maximum of numbers or strings list
  385. MAX      └{num1...numn}    (one string may not contain <space> or <tab>)
  386.  
  387. FPATH       {file}       full pathname of a filename
  388. FDRIVE      {file}       drive of a filename
  389. FDIR        {file}       drive & directory of a filename
  390. FEXT        {file}       extension of a file name (no period included)
  391. FNAME       {file}       name of a file without extension
  392. FXNAME      {file}       name & extension of a file
  393. FSIZE       {file}       size of a file
  394. TRUENAME    {file}       full truename of a file
  395. LINE        n            read the <n>-th line from standard input
  396. STDERR      n            read the <n>-th line from standard error
  397.  
  398.  
  399.  
  400. Version 1.1
  401. ===========
  402.  
  403.         First shareware version.
  404.         
  405.  
  406.         
  407. Version 1.0
  408. ===========
  409.  
  410.         Creation for personal use.
  411.  
  412.                ╔══════════════════════════════════════╗
  413.                ║    XSET: Extended SET Instruction    ║
  414.                ║                                      ║
  415.                ║      (C) 1991-1994 STERN Marc        ║
  416.                ╚══════════════════════════════════════╝
  417.  
  418.  
  419.     Everything you always wanted to put in an environment variable but
  420.     were afraid to ask DOS for...
  421.  
  422.         XSET: The easy way to write efficient batch files.
  423.  
  424.     XSET allows you to put EVERYTHING you want in a  variable  of  the
  425.     current DOS environment and use it as if you  assigned  it  the  value
  426.     with the standard DOS command 'SET'. You will be able  to  write  very
  427.     efficient batch files including string manipulation, calculation,...
  428.  
  429.     XSET is  the  most  powerful  environment  variables  manipulation
  430.     program you ever saw. It also has  a  very  easy  and  intuitive  user
  431.     interface (very close to the DOS 'SET' command). It is not a  resident
  432.     program; it so cannot interfere with any of your other applications.
  433.  
  434.     XSET is fully compatible with MS-DOS (from 3.30), PC-DOS, DR-DOS,  4DOS,
  435.     NDOS, Windows, OS/2, ...
  436.  
  437.  
  438.     XSET has seven major features:
  439.     ═════════════════════════════
  440.  
  441.      - XSET permits to catch  the  output  of  any  command  (internal  or
  442.        external) or program and put it into an environment variable.
  443.  
  444.      - XSET has several built-in  commands  to  modify  the  output  of  a
  445.        program or a string given on the command-line (extract a part of  a
  446.        string,...)
  447.  
  448.      - XSET has a built-in full floating-point calculation  functionality:
  449.        You can program incremental loops, input a calculation  string  and
  450.        output the resulting number,...
  451.  
  452.      - XSET can manage variable contents of more than 128 characters (your
  453.        path can now be as long as you want)
  454.  
  455.      - XSET has some other built-in commands to give you  access  to  some
  456.        system data (date, time, ...)
  457.                   
  458.      - XSET has built-in commands to clear all environment  or  restore  a
  459.        previously saved one.
  460.                 
  461.      - XSET gives you access to  high-level  user  interface  input/output
  462.        (line-editing, colors, windows, boxes,...).
  463.  
  464.  
  465.      More than 60 commands to do all what you need.
  466.  
  467. STERN Marc
  468. Av. de la Basilique 376 bte 19
  469. 1080 Bruxelles
  470. Belgium
  471.       
  472. Tel:  +32-2 525.63.32 ( 9h - 16h Central European Time )
  473.       +32-2 427.98.52 ( after 18h Central European Time )
  474.  
  475. E-mail:  stern@mble.philips.be           (internet)
  476.          >INTERNET:stern@mble.philips.be (compuserve)
  477.          see appendix in file XSET.DOC for other networks
  478.  
  479.  
  480.